home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / g_man / cat3 / standard / bgnsurface.z / bgnsurface
Text File  |  1998-10-20  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. bbbbggggnnnnssssuuuurrrrffffaaaacccceeee((((3333GGGG))))                                                  bbbbggggnnnnssssuuuurrrrffffaaaacccceeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      bbbbggggnnnnssssuuuurrrrffffaaaacccceeee,,,, eeeennnnddddssssuuuurrrrffffaaaacccceeee - delimit a NURBS surface definition
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd bbbbggggnnnnssssuuuurrrrffffaaaacccceeee(((())))
  13.  
  14.      vvvvooooiiiidddd eeeennnnddddssssuuuurrrrffffaaaacccceeee(((())))
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _n_o_n_e
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      Use bbbbggggnnnnssssuuuurrrrffffaaaacccceeee to mark the beginning of a NURBS (Non-Uniform Rational B-
  21.      Spline) surface definition. After you call bbbbggggnnnnssssuuuurrrrffffaaaacccceeee, call the routines
  22.      that define the surface and that provide the trimming information.  To
  23.      mark the end of a NURBS surface definition, call eeeennnnddddssssuuuurrrrffffaaaacccceeee.
  24.  
  25.      Within a NURBS surface definition (between bbbbggggnnnnssssuuuurrrrffffaaaacccceeee and eeeennnnddddssssuuuurrrrffffaaaacccceeee) you
  26.      may use only the following Graphics Library subroutines:  nnnnuuuurrrrbbbbssssssssuuuurrrrffffaaaacccceeee,,,,
  27.      bbbbggggnnnnttttrrrriiiimmmm,,,, eeeennnnddddttttrrrriiiimmmm,,,, nnnnuuuurrrrbbbbssssccccuuuurrrrvvvveeee,,,, and ppppwwwwllllccccuuuurrrrvvvveeee.  The NURBS surface definition
  28.      must consist of exactly one call to nnnnuuuurrrrbbbbssssssssuuuurrrrffffaaaacccceeee to define the shape of
  29.      the surface.  In addition, this call may be preceeded by calls to
  30.      nnnnuuuurrrrbbbbssssssssuuuurrrrffffaaaacccceeee that specify how texture and color parameters vary across
  31.      the surface.  The call(s) to nnnnuuuurrrrbbbbssssssssuuuurrrrffffaaaacccceeee may be followed by a list of
  32.      one or more trimming loop definitions (to define the boundaries of the
  33.      surface).  Each trimming loop definition consists of one call to bbbbggggnnnnttttrrrriiiimmmm,
  34.      one or more calls to either ppppwwwwllllccccuuuurrrrvvvveeee or nnnnuuuurrrrbbbbssssccccuuuurrrrvvvveeee, and one call to
  35.      eeeennnnddddttttrrrriiiimmmm....
  36.  
  37.      The system renders a NURBS surface as a polygonal mesh, and calculates
  38.      normal vectors at the corners of the polygons within the mesh. Therefore,
  39.      your program should specify a lighting model if it uses NURBS surfaces.
  40.      If your program uses no lighting model, all the interesting surface
  41.      information is lost.  When using a lighting model, use llllmmmmddddeeeeffff and llllmmmmbbbbiiiinnnndddd
  42.      to define or modify materials and their properties.
  43.  
  44. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  45.      The following code fragment draws a NURBS surface trimmed by two closed
  46.      loops.  The first closed loop is a single piecewise linear curve (see
  47.      ppppwwwwllllccccuuuurrrrvvvveeee), and the second closed loop consists of two NURBS curves (see
  48.      nnnnuuuurrrrbbbbssssccccuuuurrrrvvvveeee) joined end to end:
  49.  
  50.           bgnsurface();
  51.               nurbssurface(. . .);
  52.               bgntrim();
  53.                   pwlcurve(. . .);
  54.               endtrim();
  55.               bgntrim();
  56.                   nurbscurve(. . .);
  57.                   nurbscurve(. . .);
  58.               endtrim();
  59.           endsurface();
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. bbbbggggnnnnssssuuuurrrrffffaaaacccceeee((((3333GGGG))))                                                  bbbbggggnnnnssssuuuurrrrffffaaaacccceeee((((3333GGGG))))
  71.  
  72.  
  73.  
  74. NNNNOOOOTTTTEEEE
  75.      On Impact and Infinite Reality llllmmmmccccoooolllloooorrrr cannot be called between
  76.      bbbbggggnnnnssssuuuurrrrffffaaaacccceeee and eeeennnnddddssssuuuurrrrffffaaaacccceeee
  77.  
  78.  
  79. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  80.      nurbssurface, bgntrim, nurbscurve, pwlcurve, setnurbsproperty,
  81.      getnurbsproperty
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.